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SYSYEM AND METHOD FOR MEDIATING COMMUNICATION BETWEEN 

SOFTWARE APPLICATIONS 
Related Applications 
1 "he present invention claims priority from United States Provisional Applications 
Nos. 60/235,91 5, filed September 28, 2000; 60/235,916, filed September 28, 2000; and 
60/235,91 7, filed September 28, 2000, all of which are.hereby incorporated by reference in 
their entirety. 

Field of the Invention 

The present invention relates generally to the Held of computer software applications. 
More specifically, the present invention relates to a method, system and protocol for 
mediating communication between software applications. 

Background of the Invention 

Portability of software applications between computing platforms has been an issue 
among software developers and users since beginning of the software industry. Platform 
independent languages such as Java have been developed in order to address this issue. 
However, Java and other languages claiming to be platform independent require an 
interpreter running on the same computing platform so as to convert the platform independent 
code into instructions the processor upon which the code is running on can understand and 
execute. Because of the requirement for an additional level of processing, i.e. interpreting, 
code written in Java and other platform independent languages typically runs less efficiently 
and requires relatively greater resources than code performing the same function in a 
processor's native language, code compiled specifically for the processor the code is running 
on. Therefore, code written in Java or another platform independent language usually runs 
slower than functionally equivalent code in a processor's native language, machine language 
produced by a compiler. 



One solution for speeding up the performance of applications written in platform 
independent languages is to offload some operations to concurrently running applications 
written in the processor's native language and to use a mediation protocol to interact between 
the two applications. 

Summarv of the Invention 
The present invention is a method, system and protocol for mediating communication 
between a first and second software application. As part of the present invention, an 
application written in a first computer language may be compiled and/or linked to a first 
mediation module and an application written in a second computer language may be 
compiled and/or linked to a second mediation module. The first and second mediation 
modules may communicate with each other utilizing one or more protocols, providing for 
communication of various data types, including but not limited to function calls, function 
parameters, function results, and event notification. 

Brief Description of the Drawings 
The subject matter regarded as the invention is particularly pointed out and distinctly 
claimed in the concluding portion of the specification. The invention, however, both as to 
organization and method of operation, together with objects, features, and advantages thereof, 
may best be understood by reference to the following detailed description when read with the 
accompanying drawings in which: 

Fig. 1 Shows a diagrammatic illustration of two applications linked to and communicating 
through two mediation modules according to the present invention; 

Fig. 2 Shows a flow diagram illustrating the steps of by which a first application calls a 
function of a second function using the mediation modules of the present invention; and 
Fig. 3 Shows a diagrammatic illustration of a first application using several mediation 
modules. 
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It will be appreciated that for simplicity and clarity of illustration, elements shown in 
the figures have not necessarily been drawn to scale. For example, the dimensions of some of 
the elements may be exaggerated relative to other elements for clarity. Further, where 
considered appropriate, reference numerals may be repeated among the figures to indicate 
corresponding or analogous elements. 

DETAILED DESCRIPTION 

In the following detailed description, numerous specific details are set forth in order 
to provide a thorough understanding of the invention. However, it will be understood by 
those skilled in the art that the present invention may be practiced without these specific 
details. In other instances, well-known methods, procedures, components and circuits have 
not been described in detail so as not to obscure the present invention. 

Unless specifically stated otherwise* as apparent from the following discussions, it is 
appreciated that throughout the specification discussions utilizing terms such as "processing", 
"computing", "calculating", "determining", or the like, refer to the action and/or processes of 
a computer or computing system, or similar electronic computing device, that manipulate 
and/or transform data represented as physical, such as electronic, quantities within die 
computing system's registers and/or memories into other data similarly represented as 
physical quantities within the computing system's memories, registers or other such 
information storage, transmission or display devices. 

Embodiments of the present invention may include apparatuses for performing the 
operations herein. This apparatus may be specially constructed for the desired purposes, or it 
may comprise a general purpose computer selectively activated or reconfigured by a 
computer program stored in the computer. Such a computer program may be stored in a 
computer readable storage medium, such as, but is not limited to, any type of disk including 
floppy disks, optical disks, CD-ROMs, magnetic-optical disks, read-only memories (ROMs), 
random access memories (RAMs) electrically programmable read-only memories 



(p,PROMs), electrically erasable and programmable read only memories (EEPROMs), 
magnetic or optical cards, or any olhcr type of media suitable for storing electronic 
instructions, and capable of being coupled 10 a computer system bus. 

The processes and displays presented herein are not inherently related to any 
particular computer or other apparatus. Various general purpose systems may be used with 
programs in accordance with the teachings herein^ or it may prove convenient to construct a 
more specialized apparatus to perform the desired method. The desired structure for a variety 
of these systems will appear from the description below. In addition, embodiments of the 
present invention are not described with reference to any particular programming language. 
It will be appreciated that a variety of programming languages may be used to implement the 
teachings of the inventions as described herein. 

The present invention is a method, system and protocol suitable for mediating 
communication between an application written in a platform independent language, running 
on a specific processor or computing platform, and an application written in the processor's 
native language. As part of the present invention, an application written in a platform 
independent code may be compiled and/or linked to a first mediation module and an 
application written in the processor's native code may be compiled and/or linked to a second 
mediation module. The first and second mediation modules may communicate with each 
other utilizing a stream protocol providing for communication of various data types, 
including but not limited to function calls, function parameters, function results, and event 
notification. 

Turning now to Fig, I, there is shown a first application 100 linked to a first 
mediation module 120, both of which may run in a single process. A second application 200 
is linked to a second mediation module 220. The first and second mediation modules may 
communicate with one another utilizing a stream protocol. In an embodiment of the present 
invention, the first application 100 is written in a platform independent language, e.g. Java, 
and the first mediation module 120 causes the second application 200, written in the 
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processor's native code, e.g. C, to be launched. The first mediation module 120 may i SSue a 
command causing the operating system to produce an instance of the second application 200 
and the second mediation module 220. 

The first application 100 may pass a function call to the second application 200 
5 through the first 120 and second 220 mediation modules, respectively. The second 
application 200 may pass the results of the function to the first application 100, also through 
the first 120 and second 220 mediation modules. In addition to passing function calls and 
their associated parameters, each of applications, 100 and 200, may also pass function results 
and event notification to the other. In one embodiment of the present invention, the 
.0 application written in a platform independcnl or interpreted language passes a function call to 
an application written in the processors native code. 

Turning now to Fig. 2, there is shown a flow chart with the steps of a method 
ffj according to the present invention by which a first application passes a function call to a 

| second application. As part of step 1000, a first application 100 issues a function call for a 

fj] .5 function contained within a second application 200. The first application's function call a„d 
' Q associated parameters are passed to a first mediation module 120 where they are translated 

jO into a stream protocol and transmitted. Step 2000. The function call and associated 

g parameters, in the stream protocol format, are received by the second mediation module 220 

h& and translated into a format suitable for the second application 200 (Step 3000). The second 

20 application 200 may return a value, a series of values, or some other result (Step 4000). The 
results may take a reverse path back the first application 100, that is, through the second 
mediation module (step 5000) and through the first mediation module (step 6000). The first 
application 1 00 may receive the result in its own formal (step 7000) once the first mediation 
module 1 20 converts the results from the streom protocol (step 6000). 

Communication between mediation modules occurs using a stream protocol or other 
protoco. mat may provide ordered delivery of data over multiple streams, for example 
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TCP/IP streams. A mediation protocol may be used over a communications protocol , 0 f orm 
a stream protocol according to the present invention. 

The following is a„ example of functions performed by a mediation protocol 
according to the present invention: 

1. The first application may launch the second, providing it, by means of command- 
line arguments (or other mechanism) witfi numbers of two TCP/IP ports to be 
used for communication between the two applications. The first port number is 
termed the Command Port and the second the Event Port. 

2. The second application, when launched, stores the command port number and 
event port number for future reference in a place accessible to its mediation 
module. 

3. When the second application first attempts to perform an operation using its 
mediation module, it opens up a stream for event notifications by connecting a 
TCP/IP client socket to the event port. This is termed the Event Stream. 

4. When the second application requires that a function call be made through its 
mediation module, the following steps arc performed: 

a. If this is the first time that a function call has been made from the system 
thread from which the call is made, a new stream connection is opened up 
for the exclusive use of this thread. This is done by connecting a TCP/IP 
client socket to the command port. Details of this connection are then 
stored for fi«Ure reference. Each such stream connection has its Own 
memory buffers, and calls through one such stream connection arc 
executed independently of calls though another connection. This ensures 
thread-safety of the system, 
b. If this is not the first time that a function call has been made from the 
current system .hread, the second application's mediation module looks up 
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a connection it has previously stored for this thread, and uses this 

connection. 

c In order to call a function, the second application first needs a reference to 
the function to be called. This may have been stored from a previous use 
of the function, or may be acquired as follows: 

i- The second application's mediation module sends a request for a 
function reference number to the mediation module of the first 
application. The request includes the package name, class name 
and method name of a static Java method to be invoked, 
ii. The mediation module of the first application receives the request 
and uses Java's reflection mechanism to identify a method that 
matches the request. 

iii. The meditation module of the first application allocates a reference 
number for the method. It then stores this number and a reference 
to the method in a table for future reference. 

iv. The mediation module of the first application sends the reference 
number along with details of the types of parameters, and the return 
type, of the requested method. 

v. The mediation module of the second application receives the 
reference number and the parameter types and.return types. 

vi. The mediation module of the second application builds a data 
structure describing the Java method and containing the reference 
number. It then returns this data structure to the second application 
as a remote function reference, 
me second application makes a function call through its mediation 
module, providing it with the following information; 
i. A reference to a function, as described above 
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ii. The parameters to the function call 

"i. A memory address where the meditation modulo can store the 
result of the function call, 
c The second application's mediation modu.e posses the following 
information to the first application's mediation module: 
i. The reference number of the function 
ii. The parameters to the function call 
f. If. and oniy if. the function call is of a type that returns a result, the second 
appiication's mediation module waits for a result to be returned from the 
first application's mediation module before proceeding. 
8. If the function call is of a type that does not return a result, the second 
application's mediation module has no* completed its work for this 
function call, and returns control to the second application. 
1 h - The WKcaflon-. mediation module receives the reference number of 

the function and its parameters, 
i. The first application's mediation module uses the reference number ofthe 
function to .ook up i„ . te b.e a Java method reference that it has previously 
stored. This method is .hen invoked using Java's reflection mechanism, 
j. If the function call is of a type that returns a result, the first application's 
mediation module sends the return result to the second application's 
mediation module. 

k. The second application's mediation module returns the result of the 
function call to the second application. 
5. When the first application requires mat the second application be notified of some 
event, its mediation module sends a sig„ a , on me event $tream ^ ^ 
contains no information in itself. 
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6- When the second app.ication checks if a „ y events are waiting for its medtotion 

module checks the event stream to see if any notification, arc waiting on it. 
7. When the S econd application has processed ^ evcm> i|s 

removes the event signal from the event stream. 
Turning now to Hi s . 3. there is shown a di agrammilt ic iI(ustration ofa firs< 
using sever*, Nation modules. A first app.ication, for Cxamp)e . ^ 
■nterprcted app.ica.ion, may issue several function ca„ s where each function is contained by a 
separate native code app.ication. Fig. 3 shows a tel appIicat i on 100 cornmunicatine with „ 
second app.ica.ion 200A through mediation modu.es 120A and 220A. ^ «rs, appHc 3tio n 
1 00 may also communicate a second application 200B through mediation modu.es , 20B and 
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WhiLe certain features of the invention have been i.mstraced aml described ^ 
many modifications, substitutions, changes, and equivalent, wi„ „„ w occur to those ski„ed in 
the art. It is, therefore, to be understood that the appended claims are intended to cover all 
such modifications and changes as fall within the true spirit of the invention. 
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